@openpresentation/opf 0.26.4 → 0.26.5

package/README.md

@@ -105,6 +105,8 @@ Two browser-safe subpaths for source editors, the CLI and agents. `@openpresenta
 
 `validate(input, options?)` is the one checker, from the root and from `@openpresentation/opf/validator`. `input` is a parsed presentation or strict JSON text; the result is a `ValidationReport` whose `findings` (the shared `Finding` format, `spec/schemas/finding.schema.json`) each have a stable `opf/<rule>` id, a severity and one of six categories: `format` (JSON syntax, duplicate keys, schema), `references` (catalog references, assets, citations, datasets), `policy` (host `contracts`), `accessibility` (contrast, alt text, reading order, links), `layout` (overflow, type size, image resolution, fonts) and `content` (placeholders, empty slides, non-numeric chart cells). `valid` means no finding has severity `error`, which by default only `format`, `references` and `policy` findings can have. Text input adds line and column; `only`, `ignore` and `severity` pick and promote rules or categories; composition is lazy, so `validate(deck, { only: ["format"] })` costs what a schema check costs. Read-only and deterministic: no remote resources are fetched. See [the validate guide](../../docs/validate.md). A clean report does not certify layout, fonts, or native export fidelity.
 
+`describeFinding(finding, { document })` and `explain(ruleId)` put findings in plain words. `describeFinding` (from `@openpresentation/opf/source`) returns `{ message, next }` for any finding: what is wrong with the field in backticks, and what could come next ("did you mean `center`?"), written from the finding's own data and the document; every `opf/*` rule has its text. `explain` (also on the package root) returns a rule's summary, rationale, `fix` and a small before/after `example`. See [Plain-words text and `explain`](../../docs/validate.md#plain-words-text-and-explain).
+
 ### Patch, diff, merge and format (0.12.0)
 
 Added in 0.12.0 (not in 0.11.4 or earlier): `@openpresentation/opf/patch` is the one RFC 6902 implementation the CLI and the editor share (`applyPatch`, `applyPatchWithInverse`, `invertPatch`, strict pointer helpers, optional schema validation of the result); `@openpresentation/opf/diff` has `diff` (slide matching by id, content and similarity, moves, a readable report and a JSON Patch) and `merge` (three-way merge with conflict objects that never drop a side); `@openpresentation/opf/format` has `format` (canonical key order and layout, idempotent). See [the guide](../../docs/patch-diff-merge-format.md).

package/dist/browser.js

@@ -1,19 +1,20 @@
-import { OPFApiError } from './chunk-NZLW6FBQ.js';
-export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, copySlides, edit, embed, fill, fillRecords, localAssetSources, moveToCustom, parseSlideSelection, sameRecord, stats, updateFromCatalog } from './chunk-NZLW6FBQ.js';
+import { OPFApiError } from './chunk-UFEWQDQI.js';
+export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, copySlides, edit, embed, fill, fillRecords, localAssetSources, moveToCustom, parseSlideSelection, sameRecord, stats, updateFromCatalog } from './chunk-UFEWQDQI.js';
 export { specFileEntries, specFileKinds, specFilePaths } from './chunk-UJSAR6GF.js';
 export { FONT_POLICY, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor } from './chunk-PJSPHHRK.js';
 export { OPFDataImportError, ingest, parseTabularData } from './chunk-TKQ2VFV5.js';
-export { OPFPaginationError, paginate, paginateSlide } from './chunk-QH2W6HIM.js';
-export { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-EDCRBTJF.js';
-export { fromMarkdown, toMarkdown } from './chunk-GWJBZ4LC.js';
-import './chunk-PIO73BQ6.js';
+export { OPFPaginationError, paginate, paginateSlide } from './chunk-EFMR32A5.js';
+export { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-STIYINEL.js';
+export { fromMarkdown, toMarkdown } from './chunk-UY6SQVR2.js';
+import './chunk-WAZDP2WS.js';
 import './chunk-RYZPBJLB.js';
-import './chunk-MN7DRK57.js';
-import './chunk-O6BY3AU2.js';
-export { OPFMarkdownError } from './chunk-QAEBYDKY.js';
-import './chunk-6NBTZYYD.js';
-export { diff, merge } from './chunk-H5QC3X3K.js';
-export { CATALOG_SCHEMA, DEFAULT_VALIDATION_THRESHOLDS, OPFPatchError, OPFPatchValidationError, OPFValidationError, applyPatch, assertValid, assertValidCatalogRecord, catalogDisplayKinds, catalogSchemaNames, findValidationRule, resolveSlideContext, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-XFOOKVRI.js';
+export { explain } from './chunk-MD3CJ5YJ.js';
+import './chunk-MLH5LIGF.js';
+import './chunk-DXTPLVAK.js';
+export { OPFMarkdownError } from './chunk-KPALXWX3.js';
+import './chunk-HPEZCAYC.js';
+export { diff, merge } from './chunk-TAV5S2JG.js';
+export { CATALOG_SCHEMA, DEFAULT_VALIDATION_THRESHOLDS, OPFPatchError, OPFPatchValidationError, OPFValidationError, applyPatch, assertValid, assertValidCatalogRecord, catalogDisplayKinds, catalogSchemaNames, findValidationRule, resolveSlideContext, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-CIWC7DRZ.js';
 export { CATALOG_GROUP_PATTERN, CATALOG_REFERENCE_PATTERN, CHART_TYPES, DEFAULT_VARIABLE_DATE_FORMAT, ENGINE_DEFAULT_CHART_TYPES, ENGINE_DEFAULT_COLOR_SCHEME, ENGINE_DEFAULT_FONT_SCHEME, ENGINE_DEFAULT_THEME, LANGUAGES, LOGO_SHAPES, OPFCatalogsOptionError, OPFUnresolvedReferenceError, OPFVariableError, SLIDE_SCOPED_BUILTINS, SOCIAL_PLATFORMS, VARIABLE_KINDS, catalogGroupSource, catalogKinds, catalogRecords, catalogReferenceSites, chartNumber, coerceVariableValue, datasetDiagnostics, formatDataNumber, formatVariableNumber, fromExcelNumberFormat, hasContentVariables, inlineChartData, inlineDatasets, inlineTableData, isDatasetRef, isTemplate, isXYChartType, listBuiltinVariables, listVariables, normalizeLanguageFamily, numberFormatError, parseReference, resolveChartData, resolveDesignRecords, resolveFontScheme, resolveReference, resolveSlideVariables, resolveTableData, resolveVariables, suggestChartNumberFix, tableCellDisplayValue, toExcelNumberFormat, unresolvedReference, unusedDatasets, variableDeclarations } from './chunk-XRMV2GMB.js';
 export { OPFFormatError, format } from './chunk-EQ6S5SEZ.js';
 export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-F4HFDP6I.js';